Skip to content

Conversation

@olaservo
Copy link
Member

This adds a resource collection example demonstrating the pattern where a single resources/read request returns multiple ResourceContents with different URIs. This is useful for modeling collections, indexes, or composite resources.

The example includes:

  • A summer specials collection that returns all items
  • Category-filtered collections for accessories, footwear, and skincare
  • Individual item resources for direct access

Based on the gist provided by @olaservo:
https://gist.github.com/olaservo/585b1ad042723a824b6a0e0e02ae60a8

Fixes #3130

Generated with Claude Code) | Branch | [View job run](https://github.com/modelcontextprotocol/servers/actions/runs/20896646917

This adds a resource collection example demonstrating the pattern where
a single resources/read request returns multiple ResourceContents with
different URIs. This is useful for modeling collections, indexes, or
composite resources.

The example includes:
- A summer specials collection that returns all items
- Category-filtered collections for accessories, footwear, and skincare
- Individual item resources for direct access

Based on the gist provided by @olaservo:
https://gist.github.com/olaservo/585b1ad042723a824b6a0e0e02ae60a8

Fixes #3130

Co-authored-by: Ola Hungerford <olaservo@users.noreply.github.com>
@olaservo
Copy link
Member Author

Keeping this in draft for now since claude generated this based on my gist and it still needs to be tested.

@cliffhall
Copy link
Member

Keeping this in draft for now since claude generated this based on my gist and it still needs to be tested.

Looking good so far. Great idea. I didn't know we could produce PRs with this thing. Maybe we should do more of this with some bug fixes.

@olaservo
Copy link
Member Author

@claude can you please update the docs and Readme for this server so that they include information on this new example?

@claude
Copy link
Contributor

claude bot commented Jan 22, 2026

Documentation updates completed

I've successfully updated the documentation for the everything server to include information about the new resource collection example.

Changes Made

  • Updated src/everything/docs/features.md to document the resource collection pattern
  • Updated src/everything/README.md to mention the resource collection example in the introduction
  • Created commit with the documentation changes

Summary

I've updated both the README and the features documentation to describe the new resource collection example. The updates include:

In features.md:

  • Added a new section under Resources explaining the collection pattern
  • Documented all three collection resource types:
    • demo://collection/summer-specials - returns all items
    • demo://collection/by-category/{category} - filtered by category
    • demo://collection/item/{id} - individual item access

In README.md:

  • Added a brief description of the resource collection pattern to the introduction
  • Explains that it demonstrates how a single resources/read request can return multiple resources with different URIs

Note on Pushing

I've created the commit locally, but I encountered a permissions issue when trying to push to the remote branch. The GitHub Actions bot doesn't have push permissions to this repository. You'll need to manually push the commit or grant the necessary permissions.

The commit is ready and includes:

  • Proper commit message describing the changes
  • Co-authored-by attribution for both you and Claude

View job run | Branch

@olaservo olaservo added the server-everything Reference implementation for the Everything MCP server - src/everything label Jan 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

server-everything Reference implementation for the Everything MCP server - src/everything

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Resource Collection example to Everything server

3 participants